home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 3 / The Pier Shareware Number 3 (The Pier Exchange) (1993).iso / gap / gap_pro.txt < prev    next >
Text File  |  1993-09-19  |  10KB  |  201 lines
  1.  
  2.  
  3. RoboSoft systems is pleased to offer several utilities for the GAP sysop 
  4. in our GAP-Pro line of programs.  The GAP-Pro line currently consists 
  5. of:
  6.  
  7.     GAP_LIST - The External File Lister for GAP
  8.     GAP_Verify - The External Filebase Verifier for GAP
  9.     Forum_Shuffle - The Forum Arranger for GAP
  10.     GAP_Merge - The Filebase Merger/Re-arranger for GAP
  11.  
  12. All of the GAP-Pro utilities are available for download from The Cookie 
  13. Jar at 714-997-0350.
  14.  
  15.  
  16. -----------------------------------------------------------------------
  17.  
  18.  
  19.               GAP_LIST - The External File Lister for GAP          
  20.  
  21. GAP_LIST is an external program used to generate file listings for GAP 
  22. BBSs.  It will allow you to easily and quickly create file listings 
  23. while you wait or in an event.
  24.  
  25. Why do you need a program such as this when GAPFILE can already produce 
  26. file listings?  Well, to start with, GAP_LIST was created with just one 
  27. purpose in mind -- to create file lists.  It has been highly optimized 
  28. for this specific mission.  GAP_LIST also generates all of the
  29. requested listings with just a single pass through the database.  What 
  30. this adds up to is speed and flexibility. On my system I can generate 
  31. condensed and enhanced listings for all areas AND for each subject in 
  32. those areas, in well under half the time it takes to do just a 
  33. condensed listing with GAPFILE.
  34.  
  35. Here's a brief list of GAP_LIST's major features:
  36.  
  37.  - Creates Master lists of all areas and subjects specified in the 
  38.    configuration file.      
  39.  - Creates Area (Forum) lists including all subjects or individual 
  40.    subjects specified in the configuration file.    
  41.  - Creates individual listings for each area/subject.  (Registered 
  42.    version only)    
  43.  - Can create separate Condensed, Enhanced, Raw, and New (Registered 
  44.    version only) File listings in each of the categories above.    
  45.  - Creates a color summary bulletin listing the number of files and 
  46.    total bytes in each area and subject.    
  47.  - Allows files to be excluded from the listings according to security 
  48.    level.    
  49.  - Multi-user version can be run while users are still online.    
  50.  - Configuration file is plain ASCII so it's easy to change and you can 
  51.    have any number of different configurations.           
  52.  
  53. GAP_LIST comes in two versions, one for single-node boards and one for 
  54. multi-node boards.  (The multi-node version is available to registered 
  55. users only.) You can use the single-node version on multi-node boards, 
  56. but you must be sure that all nodes are inactive before running 
  57. GAP_LIST. The multi-node version allows you to generate file listings
  58. while users are online and can be easily set up to run from an event.  
  59. (The multi-node version requires that you have a multi-node version of 
  60. GAP.)
  61.  
  62.  
  63. -----------------------------------------------------------------------
  64.  
  65.  
  66.      GAP_Verify - The External Filebase Verifier for GAP
  67.        
  68.  
  69. GAP_Verify is a batch mode maintenance tool for the GAP filebase.  It's 
  70. primary functions are:
  71.  
  72.   1.  Verify the size, date, and location of files in  the 
  73.       filebase.  
  74.   2.  Word-wrap the enhanced descriptions to fit the 72-character line 
  75.       allowed by GAP.  
  76.   3.  Extract and use FILE_ID.DIZ descriptions if found in .ZIP files.  
  77.   4.  Re-parse the keywords using a sysop-defined list of words to be 
  78.       excluded from use as indexed keywords.  
  79.   5.  Look for "lost" files on the hard drive.  These are files that 
  80.       exist on the hard drive but aren't in the GAP filebase.
  81.  
  82. There are many options available to control exactly what gets done and 
  83. how it is accomplished, but these are the base functions.
  84.  
  85. To provide for extremely fast operation, GAP_Verify makes use of 
  86. advanced virtual memory techniques.  If you have a couple megabytes of 
  87. EMS/XMS memory available, GAP_Verify should just about fly on your 
  88. machine.  The verify process should run anywhere from twice as fast to 
  89. upwards of ten times as fast as the GAPFILE UPDATE function, depending 
  90. on exactly what is being updated.
  91.  
  92. GAP_Verify can word-wrap the enhanced descriptions to 72-character 
  93. lines, optionally filtering out the high-ASCII characters often used to 
  94. draw cute boxes around the descriptions.  
  95.  
  96. You can have GAP_Verify look for a FILE_ID.DIZ in each .ZIP file it 
  97. verifies.  If found, the DIZ description will be extracted and used to 
  98. replace the current description.  Related to this function is the 
  99. ability to specify a list of words which should not be indexed as 
  100. keywords if found in the DIZ description.  This can cut down 
  101. tremendously on the size of your FILEKEY files by eliminating nonsense 
  102. keywords.
  103.  
  104. GAP_Verify can re-parse the existing keywords using the keyword 
  105. exclusion list mentioned above.  The parsing algorithm used by 
  106. GAP_Verify is slightly different than that used by GAP itself and 
  107. should result in a slight improvement in the resulting list of 
  108. keywords.
  109.  
  110. GAP_Verify can also print out a list of the files encountered in the 
  111. directories it searched during the verification process that did not 
  112. show up in the filebase.  If used correctly, this can help find a lot 
  113. of dead wood on your hard drives (or locate files that fell into the 
  114. cracks).
  115.  
  116. One particularly handy use for GAP_Verify is to periodically scan your 
  117. upload area and extract the FILE_ID.DIZ descriptions from the files 
  118. uploaded in non-batch mode.  It will also update the file sizes to 
  119. correct for comments added to the ZIP during UPCHECK processing.
  120.  
  121. Because the whole idea behind GAP_Verify is speedy verification of your 
  122. filebase, it allows a great degree of control over which files are 
  123. verified and which directories are searched when looking for files.  
  124. You can tell GAP_Verify to ignore one or more partitions during its 
  125. scan of the filebase.  Any files that reside on those partitions, 
  126. according to the location in the filebase, will be completely skipped.  
  127.  
  128. You can tell GAP_Verify to scan entire partitions, specific 
  129. directories, or any combination of the two.  So if you want it to scan 
  130. all of drive D:, but only a couple directories on drive E:, GAP_Verify 
  131. can handle it.
  132.  
  133. You can provide a list of specific files that should be skipped.  This 
  134. list gives you complete control over exactly which characteristic of 
  135. the file (size, date, location, description, DIZ, keywords) should be 
  136. skipped/ignored during the verification.  Because this list might be 
  137. rather lengthy, GAP_Verify can even generate one for you.
  138.  
  139. If you use the parameter file method to tell GAP_Verify which 
  140. partitions and/or directories to scan, it will automatically create a 
  141. file containing the names of the directories it scanned.  If, on a 
  142. later run, you haven't modified the parameter file, GAP_Verify will 
  143. simply load the directory names from the file it previously created.  
  144. If your directory structure changes infrequently, this technique can 
  145. save quite a bit of startup time.
  146.  
  147. GAP_Verify will automatically create a log file listing information 
  148. about all the filebase entries it modified.
  149.  
  150. All the GAP_Verify parameters can be specified on the command line.  If 
  151. you missed one or more required parameters, GAP_Verify will prompt you 
  152. for those parameters.  Because there are so many control parameters 
  153. whose command-line versions are a bit cryptic, you can set up an 
  154. environment variable with a default set of parameters and specify 
  155. overrides or additions, if necessary, on the command line.
  156.  
  157. If you don't want to mess with the command line, just put GAP_Verify in 
  158. your GAP default directory and run it.  It will prompt you for each 
  159. required parameter and give you a complete explanation of what each is 
  160. for.  There are a few of the "fine tuning" features of GAP_Verify that 
  161. are only available from the command line, but you'll probably never 
  162. miss them if you really don't want to mess with the command line.
  163.  
  164. -----------------------------------------------------------------------
  165.  
  166.          Forum_Shuffle - The Forum Arranger for GAP
  167.           
  168. Forum_Shuffle will allow you to quickly and easily change the
  169. arrangement of the forums on your GAP BBS.  It will do everything 
  170. except update your menus.  All you have to do is figure out what order 
  171. you want the forums in and Forum_Shuffle will do the rest, including 
  172. rearranging all the files required for GAPQWK and MainMail.
  173.  
  174. -----------------------------------------------------------------------
  175.          
  176.          
  177.        GAP_Merge - The Filebase Merger/Re-arranger for GAP
  178.  
  179.  
  180. GAP_Merge is a GAP filebase maintenance utility that will allow you to 
  181. merge two GAP filebases together or to re-arrange the ordering of 
  182. subjects in an existing GAP filebase.  The merge function is great when 
  183. adding a CD-ROM, such as one of the Pier Exchange CDs, that comes with 
  184. a GAP filebase.
  185.  
  186. GAP_Merge will allow you to specify the mapping of subjects from source 
  187. to destination filebase.  If you want files from Area 0, Subject 5 in 
  188. the source to end up in Area 2, Subject 3 in the destination, GAP_Merge 
  189. can handle it.  It will also do drive translations so you can map drive 
  190. E: from the source filebase to drive X: in the destination filebase.
  191.  
  192. If the destination filebase does not exist, GAP_Merge will create it.  
  193. This allows you to use the subject mapping capabilities to move your 
  194. files around.
  195.  
  196. GAP_Merge comes in single-node and multi-node versions.  The multi-node 
  197. version allows you to merge filebases while users are still online.  
  198. (This isn't really recommended due to the heavy load the merge places 
  199. on the system, but you can do it if you have to.)
  200.  
  201.